Une Interface de Programmation d'Application (API) est un moyen pour différents services (échanges et services fiscaux dans ce cas) d'interagir les uns avec les autres.
Parfois, les services peuvent communiquer librement en utilisant des données accessibles au public via l'API. Cependant, lorsqu'il s'agit d'interroger les informations nécessaires aux impôts (telles que les soldes de votre compte, l'historique de trading, etc.), les choses se compliquent, car ces informations sont protégées par votre nom d'utilisateur/mot de passe/2FA (que vous ne devriez jamais partager avec qui que ce soit).
L'utilisation d'une API pour connecter votre plateforme fiscale à votre compte Kraken est un moyen efficace de permettre l'accès aux données de votre compte sans partager vos informations de connexion.
Pour connecter votre plateforme fiscale à votre compte Kraken, vous devez donner à la plateforme fiscale l'accès aux informations de votre compte via une clé API.
Vous ne voulez pas que des tiers connaissent votre nom d'utilisateur/mot de passe/2FA, et vous ne voulez pas non plus qu'ils effectuent des transactions ou des retraits depuis votre compte. C'est pourquoi une clé API avec les autorisations appropriées est utilisée à la place.
Les autorisations que vous accordez à la clé API définiront les limites de ce que l'autre plateforme peut voir et faire sur votre compte.
De manière générale, les autorisations nécessaires à un logiciel fiscal pour calculer vos gains/pertes en capital sont les suivantes :
Interroger les fonds (Query funds), Interroger les ordres et transactions clôturés (Query closed orders & trades) (facultatif pour certains échanges), Interroger les écritures du grand livre (Query ledger entries) et Exporter les données (Export data).
Celles-ci sont connues sous le nom d'autorisations en lecture seule (read only), ce qui signifie qu'elles permettent à l'autre plateforme de voir les fonds de votre compte ainsi que les transactions de l'historique de votre compte, mais ne leur permettent pas d'apporter des modifications à votre compte (pas de nouvelles transactions, et pas de nouvelles opérations de financement).
Voyons à quoi cela ressemble sur Kraken PRO :
Pour savoir comment créer une API sur Kraken, veuillez consulter les informations ci-dessous.
Fonds (Funds) :
Interroger (Query) : cela permet à la clé API de consulter le solde du compte et l'historique des financements (dépôts et retraits historiques) sur le compte.
Ordres et transactions (Orders and trades) :
Interroger les ordres et transactions clôturés (Query closed orders & trades) : cela permet à la clé API de voir les ordres et transactions clôturés sur le compte (ceci est utilisé pour aider à déterminer les profits/pertes).
Données (Data) :
Interroger les écritures du grand livre (Query Ledger Entries) : cela permet à la clé API de consulter le grand livre du compte, qui est un enregistrement de toutes les transactions de trading/financement passées.
Exporter les données (Export Data) : cela permet à la clé API d'exporter toutes les données mentionnées ci-dessus, y compris l'historique de vos transactions et de votre grand livre de compte (généralement au format CSV).
Pour plus d'informations sur la connexion de votre compte Kraken à Koinly, visitez :
Commencez par sélectionner votre pays de résidence
Cliquez ensuite sur Ajouter un portefeuille et sélectionnez Kraken
Pour utiliser la méthode de 'Synchronisation automatique' (Automatic Sync) de l'API, saisissez votre clé publique (Public Key) et votre clé privée (Private Key) obtenues sur Kraken.com, puis cliquez sur Ajouter Kraken (Add Kraken).
Pour télécharger manuellement votre fichier CSV, veuillez reformater vos données en utilisant le guide CSV de CoinTracker et les charger dans le modèle CSV de CoinTracker.
Une fois cette opération terminée, faites glisser et déposez le modèle CSV de CoinTracker rempli dans la zone de téléchargement désignée.
Si vous avez besoin d'aide supplémentaire, veuillez consulter le guide étape par étape de CoinTracker ci-dessous.
Depuis la page principale, définissez vos paramètres de base
Cliquez sur l'étape suivante, puis sur 'voir plus d'options'
Sélectionnez Kraken dans la liste des portefeuilles/échanges
Veuillez copier et coller vos clés publique (Public Key) et privée (Private Key) Kraken dans les champs Clé API (API Key) et Clé secrète (Secret Key), puis cliquez sur "Connecter l'échange" (Connect Exchange).
Depuis la page principale, veuillez sélectionner 'Saisir des pièces' (Enter Coins) et rechercher et sélectionner Kraken (à ne pas confondre avec Kraken Futures).
Faites défiler jusqu'à 'Créer une nouvelle tâche Kraken automatique' (Create a new automatic Kraken Job) et collez la clé API (API Key) ainsi que votre clé privée API (API Private Key) (secrète), puis cliquez sur 'Enregistrer cette tâche Kraken' (Save This Kraken Job).
Pour télécharger manuellement votre fichier CSV, cliquez sur l'onglet 'Importation CSV' (CSV import tab), puis faites glisser et déposez votre fichier CSV et cliquez sur 'Continuer l'importation' (Continue to Import).
Enfin, veuillez cliquer sur 'Démarrer l'importation' (Start Import).
Si vous avez besoin d'aide supplémentaire, veuillez consulter le guide étape par étape de CoinTracking ci-dessous :
Depuis la page du tableau de bord (dashboard), sélectionnez le bouton + Intégration (Integration) en haut à droite :
Ensuite, sélectionnez Kraken lorsque vous êtes invité à choisir un portefeuille (Wallet).
Il est visiblement listé sous les intégrations les plus populaires (Most Popular integrations).
Sélectionnez ensuite Kraken (pour les données API Spot) ou Kraken Futures (pour les données Futures).
*Veuillez noter que les clés API de Kraken Futures sont distinctes et différentes des clés API Kraken SPOT et ne peuvent pas être utilisées de manière interchangeable*
Veuillez copier votre clé API (API Key) et votre clé privée API (API Private Key) depuis votre compte Kraken et les coller dans les champs correspondants sur le site web de Blockpit, puis cliquez sur Continuer (Continue).
Après avoir cliqué sur 'Continuer' (Continue), le processus de synchronisation de vos soldes de compte et de l'historique de vos transactions commencera. Cela peut prendre quelques secondes ou minutes en fonction de la longueur de l'historique de votre compte.
Vos soldes Kraken (et Kraken Futures) seront affichés sous Intégrations (Integrations) dans le Tableau de bord (Dashboard), où vous pourrez synchroniser les données à tout moment, ou les faire synchroniser automatiquement toutes les 24 heures avec une licence Blockpit active.
Si vous avez besoin d'aide supplémentaire, veuillez consulter le guide étape par étape de Blockpit ci-dessous.
Je reçois une erreur de clé invalide (Invalid key) lorsque j'ajoute ma clé publique et ma clé privée (Public and Private Key) à un logiciel tiers.
Si cette erreur s'affiche, assurez-vous d'abord que vous copiez correctement les clés privée et publique. Si vous le faites et que vous recevez toujours l'erreur de clé invalide, veuillez créer une nouvelle clé avec les autorisations correctes et essayez de l'ajouter à nouveau.
Mes soldes Earn/Staked ne s'affichent pas.
Certains logiciels fiscaux tiers ne parviennent pas à importer correctement nos soldes d'actifs stakés via l'API. Cela peut généralement être résolu en exportant l'historique de votre compte et en le téléchargeant manuellement sur le site tiers. Pour savoir comment exporter manuellement l'historique de votre compte, veuillez cliquer ci-dessous.
Certaines de mes transactions sont manquantes.
Les fonctions d'achat/vente instantané ne sont pas enregistrées dans l'historique des transactions du compte, mais elles peuvent être consultées dans le Ledger du compte. Certaines plateformes tierces ne sont pas en mesure d'interpréter correctement les entrées d'achat/vente dans le Ledger du compte. Si tel est le cas, veuillez exporter manuellement l'historique de votre compte et télécharger le fichier sur la plateforme tierce que vous utilisez.
J'ai téléchargé manuellement l'historique de mon compte, mais je ne comprends pas la signification des symboles.
L'historique complet de votre compte est composé de deux parties, à savoir votre Ledger et vos Trades. Commençons par en apprendre un peu plus sur les différences entre les deux.
Maintenant que nous avons une bonne compréhension des différences entre le Ledger de votre compte et l'historique des Trades, examinons comment interpréter chacun d'eux.
Est-il sûr de fournir mes clés API à un logiciel tiers ?
Tant qu'un site/une application tiers nécessite vos clés API privées Kraken, il peut y avoir des problèmes de sécurité potentiels, mais tant que vous créez une clé API spécifique avec des autorisations minimales, par exemple juste pour lire votre solde et/ou votre Ledger, il n'y a aucun risque pour vos fonds ou votre sécurité en général. Pour cette raison, il est conseillé d'accorder des autorisations de lecture seule et de créer une clé API spécifique avec ces autorisations à partager avec votre logiciel tiers de confiance.
Avertissement : Kraken ne fournit pas de conseils fiscaux. Selon le cadre réglementaire de votre pays, vous pourriez avoir à payer des impôts sur les gains en capital provenant du trading d'actifs numériques ou sur la valeur de votre portefeuille d'actifs numériques. Vous pourriez également avoir à payer des impôts sur d'autres revenus que vous gagnez, tels que les récompenses ou le prêt de vos cryptos. Le cadre réglementaire pour la taxation des cryptomonnaies diffère d'un pays à l'autre. Les États-Unis n'ont pas émis de directives spécifiques concernant la taxation des récompenses pour les résidents fiscaux américains. Nous vous conseillons vivement de contacter un conseiller fiscal personnel pour obtenir de plus amples informations sur votre situation fiscale personnelle.